package com.news.service;

import com.news.model.User;
import java.util.List;

public interface UserService {
    /**
     * 用户登录验证
     * @param username 用户名
     * @param password 密码
     * @return 如果验证成功返回User对象，否则返回null
     */
    User login(String username, String password);
    
    /**
     * 添加用户
     * @param user 用户对象
     * @return 添加是否成功
     */
    boolean addUser(User user);
    
    /**
     * 更新用户信息
     * @param user 用户对象
     * @return 更新是否成功
     */
    boolean updateUser(User user);
    
    /**
     * 删除用户
     * @param userId 用户ID
     * @return 删除是否成功
     */
    boolean deleteUser(Integer userId);
    
    /**
     * 根据ID查询用户
     * @param userId 用户ID
     * @return 用户对象
     */
    User findById(Integer userId);
    
    /**
     * 查询所有用户
     * @return 用户列表
     */
    List<User> findAll();
    
    /**
     * 检查用户名是否已存在
     * @param username 用户名
     * @return true表示存在，false表示不存在
     */
    boolean isUsernameExists(String username);
    
    /**
     * 检查邮箱是否已存在
     * @param email 邮箱
     * @return true表示存在，false表示不存在
     */
    boolean isEmailExists(String email);
    
    /**
     * 根据用户名查询用户
     * @param username 用户名
     * @return 用户对象
     */
    User findByUsername(String username);
    
    /**
     * 注册新用户
     * @param user 用户信息
     * @return 注册结果信息，成功返回null，失败返回错误信息
     */
    String register(User user);
    
    /**
     * 重置用户密码
     * @param username 用户名
     * @param newPassword 新密码
     * @return 重置结果信息，成功返回null，失败返回错误信息
     */
    String resetPassword(String username, String newPassword);
    
    /**
     * 获取用户总数
     * @param keyword 关键词
     * @return 用户总数
     */
    int getUserCount(String keyword);
    
    /**
     * 获取用户列表
     * @param page 当前页码
     * @param pageSize 每页大小
     * @param keyword 关键词
     * @return 用户列表
     */
    List<User> getUsersByPage(int page, int pageSize, String keyword);
    
    /**
     * 删除用户
     * @param userId 用户ID
     * @return 删除是否成功
     */
    boolean deleteUser(int userId);
} 